CSPS Parts Price (Old)
⚠️ This API is scheduled to be decommissioned on 03/31/2026. Please migrate to the CSPS Parts Price - New API.
Detailed description of API:
Version & Updates
View Previous Revisions
| Version | Revision Date | Revision History |
|---|---|---|
| 1.0 | 20th June 2024 | New Release |
| 1.1 | 22nd Aug 2024 | URL Update |
| 1.2 | 25th Jun 2025 | Removed pagination properties and updated the sample response structure |
| Version | Revision Date | Revision History |
|---|---|---|
| 1.3 | 9th Jan 2026 | Added Decommission Notice |
Overview
CNH offers a Part Price integration with daily delta capability to seamlessly share the latest updated part price file with DMS’s. Users can retrieve the part price data file queried by date, ensuring they receive the current updated file for the following day. To access the most recent data, dealers should use the previous day as the filter. For handling large volumes of data, such as uploading new files or monthly updates, the existing SFTP is the preferred method.
Pre-requisites
Pre-requisites
- Dealer must use their Dealer Portal credentials to authorize API call.
- Each DMS provider will have a subscription_key assigned by CNHi team, please reach out to dlnadmssupport@cnh.com for assistance
- Each Subscription key is unique to DMS and the environment it belongs to
- Based on the payload (XML/JSON), user to pass the content-type in the header
Authentication
Authentication
- DMS will pass Basic auth in HTTP header with username/password
- Each DMS provider will have a subscription_key assigned by CNHi team, please reach out to dlnadmssupport@cnh.com for assistance
- The UserID and Password will be set up in the Dealer Portal by the Dealer uniquely for DMS access to interfaces
- DEP API will require subscription_key in HTTP header to identify client
API Format
- REST
The DEP takes care of the format transformations (as needed) to process the request and provide a response to the DMS system. REST format is always suggested for greater simplicity.
Connection Details
CNHi provides two environments:
- CERT / UAT
- Production
For CSPS Parts Price, CNH offers a single API:
- Parts Price List
Parts Price List
Using the CNHi eSubmission - Create Claim API, DMSs can submit a real-time requests to create a Warranty Claim
| Environment | URL | API | Request Type |
|---|---|---|---|
| CERT/UAT | https://{base_url}/external/services/cspspartsprice/pdw/list-price-parts | REST | GET |
| Production | https://{base_url}/external/services/cspspartsprice/pdw/list-price-parts | REST | GET |
Request Description
Note: validityDate is case sensitive| Name | Params Type | Type | Is Required | Default Value | Comments |
|---|---|---|---|---|---|
| validityDate | Query | Date Time | True | - | Fetch Start Date: Date to be applied as YYYY-MM-DD format Eastern Standard Time |
Response Description
| Name | Type | Description |
|---|---|---|
| statusCode | Integer | Response Status Code |
| message | String | Response Message |
| returnedDocumentsCount | Integer | Returned Documents Count |
| documents.PK_MARKETING_UNIT | String | Market code. |
| documents.PK_PRICE_LIST_CODE | string | Price list code. |
| documents.PK_PART_CODE | string | Part code. |
| documents.PK_START_VALIDITY_PRLS_DATE | DateTime | Validity start date |
| documents.DT_END_VALIDITY_DATE | DateTime | Validity end date |
| documents.NR_PRICE_AMOUNT | Integer | Price Amount |
| documents.DS_CURRENCY | String | Currency code USD, CAD |
| documents.CD_PDC | string | Part discount code |
Sample Response
Download Parts Price List SampleResponse Codes
| Status Code | Reason |
|---|---|
| 200 | Success |
| 400 | Please input a valid validity date |
| 400 | Input date cannot be future date. |
| 400 | Parts price file larger than API load [5000], total item found:[TOTALCOUNT]. Please use SFTP server to ingest file |